Skip to content

ステーキングブループリント

ステーキングブループリントは、aoでステーキングシステムを迅速に構築するための事前設計されたテンプレートです。これは、始めるのに最適な方法であり、ニーズに合わせてカスタマイズできます。

前提条件

ステーキングブループリントを使用するには、最初にトークンブループリントをロードする必要があります。

ステーキングブループリントの内容

  • ステーカー: Stakers配列は、参加者のステークされたトークンを保存するために使用されます。

  • アンステーキング: Unstaking配列は、参加者のアンステーキングリクエストを保存するために使用されます。

  • ステークアクションハンドラー: stakeハンドラーは、プロセスがトークンをステークできるようにします。プロセスがタグAction = "Stake"のメッセージを送信すると、ハンドラーはステークされたトークンをStakers配列に追加し、ステーキングを確認するメッセージをプロセスに返します。

  • アンステークアクションハンドラー: unstakeハンドラーは、プロセスがトークンをアンステークできるようにします。プロセスがタグAction = "Unstake"のメッセージを送信すると、ハンドラーはアンステーキングリクエストをUnstaking配列に追加し、アンステーキングを確認するメッセージをプロセスに返します。

  • 最終化ハンドラー: finalizeハンドラーは、プロセスがステーキングプロセスを最終化できるようにします。プロセスがタグAction = "Finalize"のメッセージを送信すると、ハンドラーはアンステーキングリクエストを処理し、ステーキングプロセスを最終化します。

使用方法:

  1. 好みのテキストエディタを開きます。
  2. ターミナルを開きます。
  3. aosプロセスを開始します。
  4. .load-blueprint stakingと入力します。

ブループリントがロードされたか確認する:

Handlers.listと入力して、新しくロードされたハンドラーを確認します。

ステーキングブループリントの内容:

lua
Stakers = Stakers or {}
Unstaking = Unstaking or {}

-- Stake Action Handler
Handlers.stake = function(msg)
  local quantity = tonumber(msg.Tags.Quantity)
  local delay = tonumber(msg.Tags.UnstakeDelay)
  local height = tonumber(msg['Block-Height'])
  assert(Balances[msg.From] and Balances[msg.From] >= quantity, "Insufficient balance to stake")
  Balances[msg.From] = Balances[msg.From] - quantity
  Stakers[msg.From] = Stakers[msg.From] or {}
  Stakers[msg.From].amount = (Stakers[msg.From].amount or 0) + quantity
  Stakers[msg.From].unstake_at = height + delay
end

-- Unstake Action Handler
Handlers.unstake = function(msg)
  local quantity = tonumber(msg.Tags.Quantity)
  local stakerInfo = Stakers[msg.From]
  assert(stakerInfo and stakerInfo.amount >= quantity, "Insufficient staked amount")
  stakerInfo.amount = stakerInfo.amount - quantity
  Unstaking[msg.From] = {
      amount = quantity,
      release_at = stakerInfo.unstake_at
  }
end

-- Finalization Handler
local finalizationHandler = function(msg)
  local currentHeight = tonumber(msg['Block-Height'])
  -- Process unstaking
  for address, unstakeInfo in pairs(Unstaking) do
      if currentHeight >= unstakeInfo.release_at then
          Balances[address] = (Balances[address] or 0) + unstakeInfo.amount
          Unstaking[address] = nil
      end
  end

end

-- wrap function to continue handler flow
local function continue(fn)
  return function (msg)
    local result = fn(msg)
    if (result) == -1 then
      return 1
    end
    return result
  end
end

-- Registering Handlers
Handlers.add("stake",
  continue(Handlers.utils.hasMatchingTag("Action", "Stake")), Handlers.stake)
Handlers.add("unstake",
  continue(Handlers.utils.hasMatchingTag("Action", "Unstake")), Handlers.unstake)
-- Finalization handler should be called for every message
Handlers.add("finalize", function (msg) return -1 end, finalizationHandler)